home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM 1996 Fall / BMUG Fall'96 PD-ROM.iso / Updaters / BBEdit 4.0.1 Update / BBEdit 4.0.1 Release Notes next >
Text File  |  1996-06-28  |  22KB  |  501 lines
  1. BBEdit 4.0 Release Notes
  2. ====== === ======= =====
  3.  
  4. June 28, 1996
  5.  
  6. This document contains important information regarding the online
  7. documention for BBEdit, as well as known conflicts with third-party
  8. software. Please read it carefully before installing the Acrobat Reader
  9. or making use of the electronic documents.
  10.  
  11. To quickly navigate to the different sections of this file, choose
  12. one of the items from the "Mark" menu.
  13.  
  14.  
  15. Obligatory Anti-Piracy Notice
  16. ---------- ----------- ------
  17. BBEdit is protected by U.S. and international copyright law against
  18. unauthorized redistribution and duplication. If you are using a non-
  19. demo copy that you obtained by a means other than a legitimate site
  20. license, product bundle, or direct purchase, then we encourage you to
  21. write to the address below and order your own copy. The pricing is
  22. reasonable, and options are available for discount and quantity
  23. pricing.
  24.  
  25.  
  26. Using Acrobat Reader 
  27. ===== ======= ======
  28. Acrobat Reader 2.1 requires the Adobe Type Manager (ATM) to run. If you
  29. already have a full version of ATM prior to 3.8.3, running the Installer
  30. will update it to version 3.8.3. If you do not have any version of ATM,
  31. the Installer will provide a limited version of ATM 3.8.3 in the Adobe
  32. Acrobat Fonts folder; this version will only load while the Acrobat
  33. Reader is open. This replaces the "ATM LE" used in earlier versions of
  34. the package.
  35.  
  36.  
  37. BBEdit 4.0 User Manuals
  38. ====== === ==== =======
  39. For your convenience, the BBEdit user manual is provided in three different
  40. page layouts:
  41.  
  42.     -  "User Manual/USLtr.pdf" contains the manual in US Letter (8.5 x 11")
  43.         format, suitable for printing on most printers.
  44.         
  45.     -  "User Manual/Screen.pdf" contains a version of the manual which is
  46.         optimized for easy on-screen viewing.
  47.         
  48.     -  "User Manual/A4.pdf" contains the manual in A4 (210 x 297 mm) format,
  49.         suitable for printing on printers supporting the A4 paper size.
  50.  
  51. Information on the HTML Tools is provided in the "HTML Tools Documentation"
  52. folder. This documentation is supplied in HTML format, so you can view it 
  53. within any Web browser, as well as directly from BBEdit. Please see the 
  54. "readme.html" file for an overview.
  55.  
  56.  
  57. Manual Addenda
  58. ====== =======
  59.  
  60. Chapter 13: Extensions
  61. ------- --- ----------
  62. The "827" character conversion utility (described on p.147 of the US Letter 
  63. manual version) has been renamed to "Convert to ASCII", but its use and 
  64. capabilities remain otherwise unchanged.
  65.  
  66. There is a new standard extension: "BinHex Fixer". This extension is
  67. designed specifically for correcting BinHex files that arrive without
  68. line breaks (usually as the result of an uploading glitch). To fix such
  69. a BinHex file, open it in BBEdit, and choose "Fix BinHex File" from the
  70. Extensions menu. Note that this extension is designed for correcting a
  71. specific type of defect, namely, the omission of line breaks. If the
  72. BinHex file is otherwise damaged or incorrectly generated, the BinHex
  73. Fixer will not be able to correct it.
  74.  
  75. Chapter 14: AppleScript
  76. ------- --- -----------
  77. BBEdit now includes full integration with Frontier 4.0, the advanced
  78. scripting system from UserLand Software, and a copy of Frontier is 
  79. supplied on the BBEdit CD-ROM. Please see the *Web Site Scripting*
  80. and *Improved Scripting Support* sections in the "What's New in BBEdit
  81. 4.0" document (in this folder) for further details.
  82.  
  83.  
  84. Other Documentation and References
  85. ===== ============= === ==========
  86. In addition to the manual files, there is a variety of additional supporting
  87. information available:
  88.  
  89.     -  The "AppleScript Samples" folder contains several example scripts. 
  90.        BBEdit Find Diffs is a stand-alone script application which lets 
  91.        you drag and drop a pair of files to compare. There is also a folder 
  92.        containing a selection of sample scripts which can be put in the 
  93.        BBEdit Scripts folder, and additional examples which demonstrate how 
  94.        to perform common actions from a script editor.
  95.     
  96.     -  The "Bare Bones Guide to HTML", a summary of HTML tag syntax, is
  97.        provided courtesy of Kevin Werbach <werbach@access.digex.net>.
  98.  
  99.     - "BBEdit Extension SDK" contains the current BBEdit Extension 
  100.        Developer's Kit, which is useful if you want to write extensions for 
  101.        BBEdit. Please note that the extension interfaces have been updated
  102.        with this version; see the included documents for details.
  103.        
  104.     - "Technical Support Bulletins" contains informational files describing 
  105.        two commonly encountered problems, and the appropriate work-arounds or 
  106.        solutions. The specific topics covered are problems with Internet 
  107.        Config 1.0, and with the Claris XTND system.
  108.  
  109.  
  110. Known Issues
  111. ===== ======
  112.  
  113. "Can't Undo" Alerts
  114. ------ ----- ------
  115. A number of actions, most notably many extensions, are not undoable.
  116. As a matter of course, BBEdit will pose an alert: "<action> is not
  117. undoable. Do you still wish to proceed?" If these alerts annoy you,
  118. you can turn them off. The appropriate option is in the Editor section
  119. of the "Preferences" dialog. (The "Preferences..." command is found 
  120. under the Edit menu.)
  121.  
  122.  
  123. Claris XTND Problems
  124. ------ ---- --------
  125. BBEdit uses the Claris XTND translator system to allow the reading
  126. and writing of various word-processor file formats. We have identified
  127. several problems in the XTND system which can interfere with BBEdit's
  128. operation, usually by causing a system crash, out-of-memory condition,
  129. hang, or other aberrant behavior. As a result, XTND services are now
  130. turned off by default; you can activate XTND by selecting it from
  131. the Services section of the Preferences dialog.
  132.  
  133. The following situations can cause your system to crash while
  134. launching BBEdit:
  135.  
  136. Excessive Memory Usage: In some situations, the XTND system makes
  137. demands on the application that exceed the application's available
  138. memory, and reacts badly when the application is unable to fill those
  139. demands. We have observed excessive memory usage caused by the presence
  140. of the Claris HTML translator, the MacLink Translator Bridge module, 
  141. and the WordPerfect 2.x translator files. Large numbers of XTND 
  142. translators can also be a contributing factor.
  143.  
  144. Damaged XTND translator or "XTND Translator List" file: In this
  145. situation, one or more XTND translator modules, or the XTND file which
  146. maintains a list of your available translators, have become corrupted,
  147. possibly by a previous system crash. When starting up, the XTND system
  148. will attempt to  read these damaged files, and will usually crash or
  149. behave in an unpredictable fashion thereafter.
  150.  
  151. Mutual recursion in your system folder: This occurs when the Control
  152. Panels and Extensions folders each contain an alias to the other. In
  153. this situation, the XTND software gets stuck in an endless loop as it
  154. follows these aliases back and forth, essentially "chasing its tail"
  155. forever.
  156.  
  157. To disable external services for BBEdit, hold down the Shift key as you
  158. launch BBEdit. (To do this, click once on the BBEdit application icon,
  159. then hold down the Shift key and choose "Open" from the Finder's File
  160. menu, or hit Command-Shift-O.) Continue holding down the Shift key until
  161. BBEdit's menu bar appears. This action will disable all of the BBEdit
  162. external services, including XTND translation. If you are able to launch
  163. BBEdit successfully using this trick, it is a near certainty that one of
  164. the situations outlined above is in force.
  165.  
  166. Your next course of action depends on your needs:
  167.  
  168. If you do not need XTND translation, go to the Services section of the
  169. Preferences dialog, and un-check the box labelled "XTND Translation".
  170. This will prevent BBEdit from activating the XTND system the next time
  171. it launches (and so on, until you re-activate this setting), thus
  172. avoiding the XTND problems altogether.
  173.  
  174. If you do need XTND translation, you can work around the problems in 
  175. the XTND system by addressing them in the order that they're listed. 
  176. Begin by removing the WordPerfect 2.0 translator, if you do not need it,
  177. followed by the MacLink Translator Bridge, and the HTML translator. If
  178. you do need any of these components, try increasing the preferred 
  179. memory partition size to 1500K (or to 2048K or more if you have many
  180. translators installed).
  181.  
  182. If this does not solve your problem, next remove the "XTND Translator
  183. List" file, which can be found in your Preferences folder. The XTND
  184. system will reconstruct the translator list as necessary.
  185.  
  186. If you have a damaged translator, you should remove all of your
  187. installed Claris translators, and add them back to your Claris
  188. Translators folder one by one, launching BBEdit each time, until
  189. the problem recurs.
  190.  
  191. Finally, check to see if your Extensions and Control Panels folders
  192. contain aliases to each other. If they do, remove one or both of
  193. the aliases to break the alias loop.
  194.  
  195.  
  196. Desktop File Problems
  197. ------- ---- --------
  198. On occasion, you may find that the Finder does not display the correct
  199. icon for BBEdit documents, or that you cannot drag documents onto the
  200. BBEdit application (or an alias to the application) to open them.
  201.  
  202. This behavior is not indicative of a problem with BBEdit; rather, it is
  203. an indication that the database that the Finder uses to associate
  204. applications, icons, and documents (known as the "Desktop file") has
  205. become confused or corrupted.
  206.  
  207. When this happens, it is usually desirable to force the Finder to rebuild
  208. the Desktop. To do this, reboot your machine, and immediately hold down
  209. the Shift key until the message "Extensions Off" appears. As soon as
  210. this message appears, release the Shift key, and hold down the Command
  211. and Option keys. For each volume that mounts at startup, the Finder
  212. will ask whether you wish to rebuild the Desktop. Click "OK", and the
  213. Finder will do so.
  214.  
  215. Corruption in the Desktop file can also render BBEdit unable to locate
  216. external services. If you have an service installed (say, the THINK
  217. Project Manager), but BBEdit does not make the service available to you,
  218. rebuilding your desktop will usually help. (This assumes that you've
  219. already checked to make sure that the application you are trying to use
  220. is of an appropriate version.)
  221.  
  222.  
  223. External Services and Startup Performance
  224. -------- -------- --- ------- -----------
  225. The first time BBEdit starts up, it attempts to locate the application
  226. associated with each external service. If the application isn't found,
  227. BBEdit will keep trying to find it on subsequent occasions, until it
  228. either finds the application, or until you turn off the corresponding
  229. check-box in the "External Services" section of the Preferences dialog.
  230.  
  231. Since an unsuccessful search for an application takes time, you should
  232. turn off the check boxes corresponding to any application you do not have
  233. available. Doing so will decrease the time it takes BBEdit to start up.
  234.  
  235. You can also improve BBEdit's startup performance by removing unused
  236. BBEdit extensions from the "BBEdit Extensions" folder.
  237.  
  238.  
  239. Memory Usage
  240. ------ -----
  241. BBEdit uses System temp memory to hold the files it opens, so you will
  242. not need to increase the application's partition size to edit large
  243. files. However, some operations, such as Copy and Paste on large blocks
  244. of text, performing a multi-file search over many files and folders, or
  245. using XTND translation to import and export files, requires that more
  246. memory be made directly available to the application. If you often
  247. perform tasks like these, we advise that you increase BBEdit's
  248. recommended memory size allocation, as your needs dictate.
  249.  
  250.  
  251. BBEdit and CodeWarrior
  252. ------ --- -----------
  253. Integration of BBEdit with CodeWarrior requires you to have version 1.2
  254. or later of CodeWarrior (distributed in "CW5" and subsequent releases). 
  255. CodeWarrior takes a somewhat more passive approach to external-editor 
  256. support, and for that reason, the following limitations apply:
  257.  
  258. -  CodeWarrior does not provide a means to select the external editor.
  259. Thus, if you double-click on a file in an open CodeWarrior project while
  260. in CodeWarrior, your source file will open up in CodeWarrior's editor.
  261. As an alternative, open your CodeWarrior projects in BBEdit. In the
  262. project browser next to the "Open" button is a small icon; click in this
  263. icon to open the project in CodeWarrior (and to launch CodeWarrior if it
  264. is not already running). When you double-click on a file in a BBEdit
  265. project browser, BBEdit will open the source file, and will enable items
  266. on the Compiler menu if the source file belongs to the project that's
  267. currently open in CodeWarrior.
  268.  
  269. -  CodeWarrior does not arbitrate with the external editor for the
  270. text. The practical result of this is that you will need to save files
  271. before compiling them, if you wish your current changes to be compiled.
  272. If CodeWarrior is the target environment, BBEdit will ask if you wish
  273. to save an unsaved file before compiling it. Also, if you choose "Bring
  274. Up To Date" or "Run", and you have unsaved source files connected to the
  275. currently open project, BBEdit will ask if you wish to save them before
  276. compiling.
  277.  
  278. The "ClickWarrior 2.0" extension supplied with BBEdit 4.0 can provide a
  279. workaround for the external editor selection issue mentioned above. You
  280. must use this version of ClickWarrior with BBEdit 4.0; older versions
  281. of ClickWarrior will not work correctly. If you are not familiar with
  282. ClickWarrior, read the "ClickWarrior READ ME" document for details.
  283.  
  284.  
  285. THINK Project Manager
  286. ----- ------- -------
  287. The THINK Project Manager, used in THINK C and Symantec C++ version 6.0
  288. and 7.0 has a number of bugs and limitations which occasionally make
  289. working with an external editor difficult. Should you have any specific
  290. concerns regarding the TPM, please check to see that you are using the 
  291. latest version available. If you are, and the problem persists, then 
  292. please contact Symantec Technical Support.
  293.  
  294.  
  295. The "Old MacTraps" File
  296. --- ---- --------- ----
  297. Versions 6.0 and later of THINK C and Symantec C++ contain a file called
  298. "Old MacTraps". This file is located in the "Mac Libraries" folder. The
  299. structure of this file is such that both the THINK Project Manager and
  300. BBEdit will crash while attempting to open this project.
  301.  
  302. If you are performing a multi-file search of your Mac Libraries folder,
  303. or of the folder containing the THINK Project Manager, BBEdit will
  304. crash when it encounters the "Old MacTraps" file. To avoid this file,
  305. remove it, or switch the "File Type" popup menu (in the Multi-File
  306. Search options portion of the Find dialog) to "Text Files".
  307.  
  308.  
  309. Printing with Substituted Fonts
  310. -------- ---- ----------- -----
  311. Because of idiosyncracies in various printer drivers, including both the 
  312. LaserWriter and StyleWriter drivers, there are some character spacing 
  313. anomalies when printing with a substituted monospaced font (i.e. Monaco). 
  314. To avoid these problems, print in a non-substituted, monospaced PostScript 
  315. font such as Courier. (With BBEdit, you can of course edit in one font, 
  316. and print in another.)
  317.  
  318.  
  319. Fractional Spacing
  320. ---------- -------
  321. BBEdit 4.0 supports a "Fractional Spacing" option when printing. We
  322. recommend that you use this option if you are printing in a small
  323. (less than 9-point) font size.
  324.  
  325.  
  326. FaxSTF "FaxPrint" Printer Driver
  327. ------ ---------- ------- ------
  328. Version 2.2.3 of the "FaxPrint" printer driver, supplied with the FaxSTF
  329. fax software package, has a bug in it which can cause all applications,
  330. not just BBEdit, to malfunction. STF Technologies has been notified of
  331. the problem. In the meantime, to avoid potential problems, choose another
  332. printer driver, such as the ImageWriter or LaserWriter driver, except
  333. when you are planning to fax documents directly from within BBEdit.
  334.  
  335. Later versions of the FaxSTF software, used under System 7.5.3, reportedly 
  336. cause problems when opening files. Contact STF Technologies for the latest
  337. information on the availability of a fix.
  338.  
  339.  
  340. LaserWriter "Preferences Damaged" Warning
  341. ----------- --------------------- -------
  342. On occasion, version 8.2.2 of the LaserWriter driver will issue a
  343. warning message about missing or damaged preferences. We have contacted
  344. Apple regarding this issue, and they believe it to be due to a bug in
  345. the LaserWriter driver. We have also had reports that the recently
  346. released LaserWriter 8.3 driver may exhibit this same problem. If you
  347. get this message, simply choose "Page Setup" or "Print" from the File
  348. menu, and you should be able to continue without any difficulty.
  349.  
  350.  
  351. NOW Utilities
  352. --- ---------
  353. Older versions of Super Boomerang have a bug which affects BBEdit;
  354. in particular, you cannot type upper-case letters in the "Save As..."
  355. dialog. This bug is fixed in version 4.0 and later of the NOW Utilities
  356. package; contact Now Software for an update.
  357.  
  358. Now Save may cause BBEdit's "File" menu to become scrambled. If this
  359. happens, turn off Now Save when running BBEdit.
  360.  
  361. Please also note that you will not be able to modify the command key 
  362. equivalents for BBEdit's menu items using Now Menus.
  363.  
  364. We have received reports of problems caused by Now Utilities 6.0, and
  365. are currently investigating. Please check our Web site at
  366. <http://www.barebones.com/support.html> for up-to-date information.
  367.  
  368.  
  369. Standard File Hacks
  370. -------- ---- -----
  371. There are some third-party extensions which modify the standard "Open"
  372. and "Save" dialogs (known colloquially as "Standard File"). In a couple
  373. of known cases, some of these extensions have a bug which causes
  374. correctly written applications to crash. Specifically:
  375.  
  376.     - "Click, there it is!", version 1.0.1. Version 1.0.4 or later have
  377.        fixed this problem. Registered owners should contact the author 
  378.        for more information.
  379.     
  380.     -  Quickeys version 2.1 also appears to have a similar problem. 
  381.        Please contact CE Software for an update.
  382.  
  383. If either of these extensions is installed, BBEdit will most likely
  384. crash when trying to bring up a Standard File dialog. (BBEdit's "Open"
  385. and "Save" dialogs should work correctly, but other dialogs, such as 
  386. the File Types section of the preferences dialog, will not.)
  387.  
  388. In addition, problems have been reported in which the Standard File
  389. Package crashes, or BBEdit takes an "emergency exit", when Peter
  390. Lewis' "CDIconKiller" extension is in use.
  391.  
  392. Finally, we have received reports that StuffIt Shortcut will sometimes
  393. cause BBEdit to crash when you choose "Open..." from the File menu.
  394. We are working with Aladdin to identify and resolve this issue.
  395.  
  396.  
  397. The BalloonWriter INIT
  398. --- ------------- ----
  399. Version 1.0.1 of Apple's "BalloonWriter" extension interferes with
  400. the correct display and operation of BBEdit's dynamic menus. To avoid
  401. this conflict, disable or remove BalloonWriter from your system.
  402.  
  403.  
  404. Famous Last Words
  405. ====== ==== =====
  406.  
  407. Documentation Errors?
  408. ------------- -------
  409. If you find an error in the documentation, please let us know. One of
  410. the reasons we have gone to CD-ROM with electronic documentation is so 
  411. that we can make revisions to the manual and incorporate the improvements 
  412. in subsequent pressings of the CD, along with improvements to the software.
  413.  
  414.  
  415. Contact Information
  416. ------- -----------
  417. Should you have questions about BBEdit, please write or send e-mail to 
  418. us at one of the addresses below:
  419.  
  420.     Bare Bones Software, Inc.
  421.     P.O. Box 1048
  422.     Bedford, MA 01730-1048
  423.     
  424.     phone:  617-676-0650
  425.     fax:    617-676-0651
  426.     
  427.     email:  support@barebones.com
  428.     Web:    http://www.barebones.com/
  429.  
  430. For technical support, bug reports, and other issues of an immediate
  431. nature, we strongly encourage you to use electronic mail.
  432.  
  433. From time to time, we will release patches to correct problems in the
  434. software, and/or add minor functionality. These patches are free, and
  435. may be freely redistributed. We do not send out notification to our
  436. customers, but we post announcements to the net and major information
  437. services as a matter of course. Current versions of these patches will 
  438. be made available on our Web page, as well as our ftp site:
  439.  
  440.     ftp://ftp.barebones.com/
  441.  
  442. We will also provide technical support bulletins, as warranted by
  443. circumstances, to address some commonly encountered problems. You can
  444. also find a list of frequently asked questions about BBEdit on our
  445. Web page with this URL:
  446.  
  447.     http://www.barebones.com/support.html
  448.  
  449. If you do have a problem with the software, please let us know. All 
  450. too often, customers do not report problems for one reason or another.
  451. Remember that if we do not hear about a problem, we can't fix it.
  452.  
  453.  
  454. Additional Acknowledgements
  455. ---------- ----------------
  456. The regular-expression library used for 'grep' searching is based on 
  457. the 'regexp' package, written by Henry Spencer of the University of
  458. Toronto. Pete Keleher provided a Mac-compatible version, from which
  459. BBEdit's code is derived.
  460.  
  461. John Norstad of Northwestern University contributed the code that
  462. BBEdit uses to resolve Internet URLs.
  463.  
  464.  
  465. Thanks!
  466. -------
  467. Thank you for purchasing BBEdit. If you have any suggestions for
  468. improvements, or any problems to report, do not be shy. Our experience
  469. shows that feedback from our customers has consistently led to better
  470. products and happier users.
  471.  
  472. Thanks also to the many people who, in one way or another, directly
  473. contributed to the production and success of BBEdit. They're all listed
  474. in the about box; choose "About BBEdit..." from the Apple menu to see
  475. their names.
  476.  
  477. Finally, thanks to all of our customers, who have invested in our
  478. product and our company, and, by doing so, have given us the ability to
  479. keep producing and improving our software.
  480.  
  481.  
  482.     Rich Siegel
  483.     Founder, President & CEO
  484.     
  485.     Michael Fryar
  486.     Chief Operating Officer
  487.     
  488.     Patrick Woolsey
  489.     Director of Technical Services
  490.     
  491.     David W. Hill
  492.     Vice President of Engineering
  493.  
  494.     Allan Rousselle
  495.     Vice President of Sales and Marketing
  496.     
  497.     Jon Hueras
  498.     Principal Software Architect
  499.     
  500. =end=
  501.